Motivation and Context

Most clients don't implement sampling yet, which complicates development and adoption of sampling.
This simple example shows how to wrap an stdio server invocation in a proxy that backfills (the context-free subset of) the sampling feature using the Claude API (needs ANTHROPIC_API_KEY environment variable).

Additional context:

• proposing updates to sampling that would add tool calling and soft-deprecate context-awareness.
• tweaking the everything server to make testing of this backfill + upcoming sep reference implementation easier: everything.sampleLLM: add includeContext & preferredModelName params servers#2802

cc/ @bhosmer-ant

How Has This Been Tested?

• Check out everything.sampleLLM: add includeContext & preferredModelName params servers#2802 and add the following run-stdio.sh script to it:

  #!/bin/bash
  set -euo pipefail
  
  cd "$(dirname "$0")"
  npm i >&2
  npm run build >&2
  npm run --silent start

• Run:

      npx -y @modelcontextprotocol/inspector \
        npx -y --silent tsx src/examples/backfill/backfillSampling.ts \
          ...path..to...modelcontextprotocol/servers/src/everything/run-stdio.sh

Breaking Changes

none

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the MCP Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed